home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
L' Effet Pommier 3
/
L'Effet Pommier - Volume 03.iso
/
Programmation
/
Tcl⁄Tk Folder
/
README-mac-tcl
< prev
next >
Wrap
Text File
|
1996-02-01
|
7KB
|
200 lines
Macintosh Tcl
by Ray Johnson
Sun Microsystems Laboratories
rjohnson@eng.sun.com
@(#) README 1.9 96/01/30 11:13:01
1. Introduction
---------------
This is the README file for the Macintosh version of the Tcl
scripting language. The file consists of information specific
to the Macintosh version of Tcl. For more general information
please read the README file in the main Tcl directory.
2. What's new?
--------------
A great deal of changes have been made to Tcl since the last
alpha release. Many of these are mentioned in the general
README about Tcl, I'll focus on those relating to the Macintosh
version of Tcl.
Path names - The way path names are handled is very different. The
old method had several draw backs (including not being able
to access certain files.) There are two methods for
specifing a path. The first is a native path. The native
path uses colons ':' as separaters - it's format is
documented in "Inside Macintosh" and is used in applications
like MPW. The second method is what we call a "network"
path. It's format is a superset of Unix style paths. Use
network paths if you write scripts that need to be cross
platform.
Sockets - Sockets have now been added to the core Tcl. Unfortunantly,
this code is largely untested. I have used the "client"
side of this code with some success. Please, report any
problems you have. However, I have a feeling it will take me
a while to work out all the bugs.
New file I/O - The file I/O subsystem has been completely rewritten.
The next step will be to provide for non-blocking I/O with
files. This will hopefully be available before we go final.
One benifit of the rewrite is better handling of aliases in
file or directory paths. (You can now make the libraries in
the extensions folder an alias to some other location.)
3. The Distribution
-------------------
Macintosh Tcl is distributed in three different forms. This
should make it easier to only download what you need. The
packages are as follows:
mactk4.1b1.sea.hqx
This distribution is a "binary" only release. It contains an
installer program that will install a 68k, PowerPC, or Fat
version of the "Tcl Shell" and "Wish" applications. In addition,
it installs the Tcl & Tk libraries in the Extensions folder inside
your System Folder. (These are just text files - no inits are
installed.)
mactcltk-full-4.1b1.sea.hqx
This release contains the full release of Tcl and Tk for the
Macintosh plus the GUSI and More Files packages which both
Macintosh Tcl and Tk rely on.
mactcl-source-7.5b1.sea.hqx
This release contains the complete source for Tcl 7.5. In
addition, Metrowerks CodeWarrior libraries and project files
are included. However, you must already have the More Files and
GUSI packages to compile this code.
4. Documentation
----------------
The "doc" subdirectory contains reference in documentation in
in the "man" format found on most UNIX machines. Unfortunantly,
there is not a suitable way to view these pages on the Macintosh.
A version suitable for viewing on the Macintosh has yet to be
developed. We are working are having better documentation for
the Macintosh platform in the future. However, if you have WWW
access you may access the Man pages at the following URL:
http://www.smli.com/research/tcl/man/
Other documentation and sample Tcl scripts can be found at
the Tcl ftp site:
ftp://ftp.aud.alcatel.com/tcl/
The internet news group comp.lang.tcl is also a valuable
source of information about Tcl. A mailing list is also
available (see below).
5. Compiling Tcl
----------------
In order to compile Macintosh Tcl you must have the
following items:
CodeWarrior Release 7 or higher
Mac Tcl 7.5 (source)
CWGUSI 1.6.4 or higher
More Files 1.4.1
The project files included with the Mac Tcl source should work
fine. The only thing you may need to update are the access paths.
6. Test suite
-------------
The Macintosh version of Tcl passes most all tests in the Tcl
test suite. The only exceptions are the tests in file.test
which still use exec. Slower Macs will also fail a test in
event.test whose timing constraints are too tight. If other
tests fail please report them. This will help make Tcl a more
robust language on the Macintosh platform.
7. Environment Variables
------------------------
Environment variables may be added to the system via three different
mechanisms. The first is automatic inclusion of system variables. These
variables include things like the system folder path. These variables are
determined at startup time (for the interpreter) but are not changed if
the system changes. The following environment variables are created via
this method:
LOGIN - holds the Chooser name of the Macintosh
USER - also holds the Chooser name of the Macintosh
SYS_FOLDER - path to the system directory
APPLE_M_FOLDER - path to the Apple Menu directory
CP_FOLDER - path to the control panels directory
DESK_FOLDER - path to the desk top directory
EXT_FOLDER - path to the system extensions directory
PREF_FOLDER - path to the preferences directory
PRINT_MON_FOLDER - path to the print monitor directory
SHARED_TRASH_FOLDER - path to the network trash directory
TRASH_FOLDER - path to the trash directory
START_UP_FOLDER - path to the start up directory
PWD - path to the application's default directory
Environment variables may also be placed in a file. A file named
"Tcl Environment Variables" may be placed in the preferences folder.
Each line of this file should be of the form "VAR_NAME=var_data".
For example,
PRINTER=Joe's LW
TCLLIBPATH=Lozoya:System Folder:Tcl Lib
The last alternative is to place environment variables in a 'STR#'
resource named "Tcl Environment Variables" of the application. This is
considered a little more "Mac like" than a Unix style Environment
Variable file. Each entry in the 'STR#' resource has the same format
as above. The source code file "tclMacEnv.c" contains the
implementation of the env mechanisms. This file contains many
#define's that allow customization of the env mechanisms to fit your
applications needs.
8. Macintosh Tcl Mailing List
-----------------------------
A Mailing List has been set up to discuss Macintosh related Tcl issues
including (but not limited to) MacTcl. In order to use this Mailing
List you must have access to the internet. If you have access to the
WWW the home page for this mailing list is located at the following
URL:
http://www.smli.com/research/tcl/lists/mactcl-list.html
The home page contains information about the list and an HTML archive
of all the past messages on the list. To subscribe send a message to:
listserv@sunlabs.sun.com
In the body of the message (the subject will be ignored) put:
subscribe mactcl Joe Blow
Replacing Joe Blow with your real name, of course. If you would just
like to receive more information about the list without subscribing
but the line:
information mactcl
in the body instead.
If you have comments or Bug reports send them to:
Ray Johnson
rjohnson@eng.sun.com